home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 6: Level 6 / 17 Bit - Level 6 (1998)(Epic Marketing)[!].iso / !new-os! / myformat-1.0 / myformat.doc < prev    next >
Text File  |  1997-08-26  |  15KB  |  308 lines
  1.                                MyFormat v1.0
  2.  
  3.                      © 1995-97 by Daniel J. Andrea II
  4.  
  5.  
  6. NOTE:  This software is offered as GIFTWARE.  If you like it, then you can
  7. send me something in payment of your choice (other programs, disks, 
  8. computers, cars, etc.) at the address at the end of this document.  No
  9. warranty of any kind is offered with this software or implied, or for
  10. suitability of purpose.  It's use is entirely at your own risk.
  11. No fees can be charged for this software, other than the nominal fees for 
  12. the cost of magnetic media and copying of the software onto that media, 
  13. not to exceed the amount of US $5 for a disk containing this software.
  14. Copies of this software must include this documentation file for 
  15. redistribution through Fred Fish or other similar software collections.
  16.  
  17.  
  18. What is it?
  19. ===========
  20.  
  21. MyFormat is a replacement for the Format command.  I wrote this because of
  22. the original Format that came with both OS2.1 and OS3.1 was severly lacking
  23. several handy features which I found useful from Olaf Barthel & MXM's
  24. Format replacement.  I also found that their program didn't draw the
  25. gadgets properly under OS3.1, thus MyFormat was born.
  26.  
  27. MyFormat works under both OS2.x and OS3.x, allowing certain extras under 
  28. OS3.x.  When operating under OS2.x, both OFS and FFS, with or without 
  29. International mode is available.  Under OS3.x, Directory Caching is
  30. available.  MyFormat does require at least KickStart v37 to run.
  31.  
  32. A quick note here.  I've had several users mention they would like to see
  33. direct support for MultiFileSystem in MyFormat.  This currently is not
  34. possible, at least until the MFS author is willing to release info on how to
  35. access MFS to change the current filesystem of the device.
  36.  
  37. However, MyFormat does somewhat support the MFS system.  If a device's
  38. filesystem is changed, either by inserting a different disk or from the MFS
  39. commodity, all you have to do is click on the device again within the Drives
  40. gadget and everything will be setup to format in the new filesystem. 
  41.  
  42.  
  43. Installation
  44. ============
  45.  
  46. To install, simply copy MyFormat and it's icon to your SYS:System directory.
  47. If you want to replace the original Format command, rename MyFormat to
  48. Format.  MyFormat will work exactly as the original when called from
  49. the Workbench.
  50.  
  51.  
  52. Usage
  53. =====
  54.  
  55. Usage of MyFormat is similar to Format.  All the command line arguments
  56. from Format are supported, along with some extras for the new features.
  57. MyFormat can format disks with or without verifying, and can install a
  58. valid bootblock which will work for both OS2.x and OS3.x.
  59.  
  60. There are three new command line arguments, BADSECTORS, BADTRACKS, INSTALL
  61. and NOVERIFY.
  62.  
  63. INSTALL tells MyFormat to install a valid 2.x/3.x Bootblock to make the disk
  64. bootable.  NOVERIFY tells MyFormat to turn off verification of the tracks
  65. as they are written to the disk.  The rest of the arguments work the same
  66. as the original Format's arguments as listed in the DOS reference manual.
  67.  
  68. The arguments BADSECTORS and BADTRACKS, tells MyFormat to mark bad sectors
  69. in a FFS/OFS Bitmap if verify is enabled.  The BADSECTORS argument tells
  70. MyFormat to mark only those sectors found as bad in the verify step, and
  71. BADTRACKS will mark the entire track (or "head") for that cylinder as bad.
  72. If the NOVERIFY option is included, then BADSECTORS and BADTRACKS are both
  73. ignored.  BADTRACKS has priority over BADSECTORS (i.e. if both BADTRACKS and
  74. BADSECTORS are on the commandline, then BADTRACKS will be chosen.
  75. Note: this only works on FFS/OFS disks, and will be disabled for any non-OFS/FFS
  76. disks.
  77.  
  78. If MyFormat is started by double-clicking its icon or from the shell with
  79. no arguments, it will open a window on the Workbench screen with several
  80. gadgets.
  81.  
  82. The Drives gadget shows the available disk drives attached to the system.
  83. Just below it is the Size gadget, which shows the number of tracks and
  84. the size of the drive in megabytes.
  85.  
  86. At the bottom of the window under the Drives gadget is a status window
  87. which shows the current operations of MyFormat.
  88.  
  89. To the right is several checkbox gadgets, and two cycle gadget.  The
  90. "use Filesystem" cycle gadget selects the FileSystem to use for formatting.
  91. Verify Writes turns on and off verification.  Install Disk turns on Bootblock
  92. installation.  Create Icons creates the disk and Trashcan icons for the disk.
  93. The "BadBlock marking" cycle gadget enables badblock marking for FFS/OFS floppies,
  94. using either sector marking or whole track marking as described in the CLI usage
  95. above.  It is dsabled on non-FFS/OFS formatted partitions and if verisy is disabled.
  96.  
  97. The Auto Start function is used to set a two second delay for 
  98. auto-formatting of a disk inserted into any of the available drives.  This
  99. feature allows almost hands-free operation for multiple disk formatting.
  100. This option is not available from the command line.  If you plan to use
  101. this with MFS running, set the filesystem you want to format to in the
  102. MFS commodity BEFORE you set the Auto Start mode and insert a disk.  Not
  103. doing so can cause unpredictable results, and you may not get the filesystem
  104. you wanted the disk formatted as.  Also, MyFormat may read the values from
  105. the device entry while MFS is changing things around and get bad info, possibly
  106. causing a crash (I haven't had this happen yet, but it is possible).  There's
  107. no way around this situation, until the author of MFS releases the info on how
  108. to set the filesystem within MFS.
  109.  
  110. The last gadgets are the Name, Start, Quick, and Stop gadgets in the bottom
  111. of the window.  The Name gadget is a text gadget into which you can
  112. enter the volume name for the disk to be formatted.  Default name is
  113. "Empty".  The Start gadget starts formatting the whole disk, and the 
  114. Quick gadget starts formatting using the quick-format option.  The format
  115. can be interrupted at any time by pressing the Stop gadget.
  116.  
  117. During formatting operations several of the gadgets are disabled which are
  118. options that cannot be changed.  Those which are not disabled may be
  119. changed at any time during format operations.
  120.  
  121. Note:  The Drive gadget does not show as disabled under OS2.x because
  122.    there is currently no way to disable that type of gadget under OS2.x.
  123.    Any activity in or on that gadget will be ignored by the program
  124.    during format operations.
  125.  
  126.  
  127. Bugs
  128. ====
  129.  
  130. There are no known bugs at this time.  If you find any, please contact me
  131. at the E-Mail address or Snail-Mail address below with bug reports.  Be
  132. sure to include information on what other software was running and what
  133. kind of system you have.  Bug fixes will be incorporated into MyFormat
  134. as soon as possible.
  135.  
  136. Note:  I have received some complaints about the size information not
  137.        being correct for some devices.  There is a program called 
  138.        ReadDevice included in this archive.  It is a Shell only program
  139.        for reading device info from the Dos.library's devicelist in
  140.        memory.  For example, to read info on DF0:, type this:
  141.           
  142.           readdevice df0:
  143.           
  144.        or for redirecting the output
  145.        
  146.           readdevice >t:temp df0:
  147.           
  148.        this will produce output to the standard output, in this case
  149.        the shell's console.  Redirect the output of the program using
  150.        standard file redirection and include the output of the program
  151.        in an e-mail letter to the address below.  This should help me
  152.        figure out how to correct the problem.  Also, include info about 
  153.        what software is used to run the device, i.e. CrossDOS for PC
  154.        format floppies, etc.
  155.  
  156. Also, I have had at least one person report not being able to format
  157. a floppy with the CrossMAC filesystem.  The track format goes fine, but
  158. the initialize process fails.  I cannot find anything in my code that could 
  159. be causing this, so if anyone else has tried MyFormat with CrossMAC, please
  160. let me know by email your results, both good and bad.  I am trying to get
  161. in contact with someone at Consultron, but have not heard back from them
  162. as of yet.  Update: v1.20 seems to have fixed this.  Please let me know
  163. if you still have problems formatting CrossMAC disks with MyFormat.
  164.  
  165. There have also been reports of not being able to format large drives,
  166. like the Iomega Zip, when using CrossDOS.  I have tried to find a problem
  167. in MyFormat, but cannot see what could be going wrong.  The best I can
  168. figure, unless I have a REALLY obscure bug, is the CrossDOS driver can't
  169. handle larger disks properly when initializing.  I have tried several
  170. different methods with my Zip drive, but cannot get it to format the drive
  171. either.
  172.  
  173. As of a full month after sending Consultron the email concerning CrossMAC,
  174. I have not heard anything.  If anyone is a registered user of CrossMAC
  175. and/or CrossDOS, please get in contact with them so I can find out what
  176. is wrong.  Have them contact me if possible.
  177.  
  178.  
  179. History
  180. =======
  181.  
  182.    v1.0   --  Initial release.
  183.    
  184.    v1.01  --  Fixed minor bug in setting of Use_Filesystem gadget during
  185.               startup and selection of drive to format.  Also recompiled 
  186.               with SAS/C v6.55
  187.    
  188.    v1.02  --  Changed operation of Use_Filesystem gadget so that it is
  189.               disabled on disks not using the standard Amiga Filesystem.
  190.               e.g.  PC formatted disks, PFS formatted disks, etc.
  191.    
  192.    v1.03  --  Changed arrangement of gadgets and how MyFormat responds to
  193.               Workbench menu originated formats.
  194.  
  195.    v1.04  --  OOPS!  Bug creeped in during rearrangement of gadgets in 1.03
  196.               regarding Auto Start.  Fixed so that Auto Start defaults to
  197.               whole disk formatting.
  198.  
  199.    v1.05  --  Altered Auto Start code to notify user at end of format
  200.               with a DisplayBeep call.
  201.  
  202.    v1.06  --  Changed disk change sensing method to recognize all diskchanges.
  203.               This change was needed because the A3000's scsi.device didn't
  204.               recognize the command I originally used for sensing disk changes.
  205.               This should now work with all removable media drives.  It works
  206.               fine with my Iomega Zip drive on the A3000 scsi.device as unit 5.
  207.             
  208.    v1.07  --  Found a bug in the disk type and size sensing code for non-Amiga
  209.               formatted disks.  This mainly affected disks greater than 50 megs
  210.               (the OFS size limit).  Now works.  Also has been recompiled with
  211.               SAS/C 6.56.  Also, this is first version to be uploaded to Aminet.
  212.    
  213.    v1.08  --  Fix minor bug in size info calulations which caused some really
  214.               weird size info to be placed in the size gadget.  Bug did not
  215.               affect formatting the disk, just the size reported in the window.
  216.               Thanks to Jon Peterson for help in tracking this down.
  217.  
  218.    v1.09ß --  Internal test versions during BadBlock marking development.
  219.    thru       Never released.
  220.    v1.12ß 
  221.    
  222.    v1.13ß --  Now includes Bad Block marking for FFS/OFS formatted partitions.
  223.    thru       This can be set to either mark sectors or whole tracks as used
  224.    v1.15ß     in the bitmap.  Added warning messages for bad sectors on the 
  225.               RootBlock track and/or track 0.  Beta versions, not released.
  226.               
  227.    v1.16  --  v1.15ß passed testing, and is now released to Aminet after
  228.               re-compiling.
  229.    
  230.    v1.17  --  The new warning messages were too long for screens less than
  231.               800 pixels wide.  Re-formatted the text.
  232.  
  233.    v1.18  --  An elusive bug, which I never saw, was discovered by Carsten Sorensen
  234.               in the GUI layout code.  I had mistakenly, way back in v1.03, set 
  235.               the topedge of some gadgets to a set value, rather than adjusting
  236.               them according to the screen's font.  This has now been fixed.
  237.               Also turned the optimizer back on in SAS/C with size optimization.
  238.               This cut the size of the code by a little more than 1K over no
  239.               optimization for v1.18.  Might even be a little faster as well.
  240.    
  241.    v1.19  --  Well, I did find another stupid bug on my part.  :-\
  242.               I had created the BadBlocks type gadget with some bad info in the 
  243.               list it used for defining the available settings.  Caused some
  244.               problems with MCP's cycle-to-menu option (caused lockups).  I'm
  245.               surprised this didn't show up until now.  Also removed a call
  246.               that would force the window to the front whenever AutoStart mode
  247.               is enabled.  I will be making some changes in MyFormat 2.0 to
  248.               make this optional, since it is rather annoying to have the 
  249.               Workbench screen pop to the front while trying to read email on
  250.               Thor's own screen.
  251.     
  252.    v1.20  --  Found another rather obscure bug, though I don't think it ever
  253.               affected anything.  I had mistakenly set the dostype for the 
  254.               disk initialization to always be an Amiga type, as in FFS.  I
  255.               had thought this might be why the CrossDOS formatting of larger
  256.               disks didn't work, but it didn't change anything on formatting
  257.               my Zip drive to PC format.  See the note above about bugs and
  258.               Consultron for more info.  Now compiled with SAS/C 6.58.
  259.               Extra nore on 1.20:  This bugfix seems to have fixed the CrossMAC
  260.               formatting problem.  If anyone still has problems with this, let
  261.               me know.  Also included a new version of readdevice with this
  262.               re-upload.  Readdevice was causing some Enforcer hits when
  263.               string pointers in the device entry are not set.  Now it includes
  264.               some more pointer checks for those entries and will accept device
  265.               names with or without the ':'.
  266.  
  267.  
  268. Author
  269. ======
  270.  
  271. I can be contacted through Internet E-Mail at:
  272.  
  273.       dandrea@unix.tfs.net
  274.  
  275. or through Snail-Mail at:
  276.  
  277.       Daniel J. Andrea II
  278.       1331 Metropolitan St.
  279.       Leavenworth, KS 66048
  280.       U.S.A.
  281.  
  282. To check up on MyFormat development and other projects when they arise,
  283. point your web browser at
  284.  
  285.       http://www.tfs.net/~dandrea/
  286.  
  287. MyFormat was developed on an Amiga 500 with a Microbotics VXL*30/RAM*32
  288. accelerator and on a 25 MHz A3000 using SAS/C v6.0 thru v6.3 and
  289. v6.55 thru v6.58.
  290.  
  291.  
  292. Future
  293. ======
  294.  
  295. Next I will try to work in a reworked, font-sensitive GUI as well as locale support.
  296.  
  297.  
  298. Thanks
  299. ======
  300.  
  301. Many thanks to my beta-testers from v1.13ß-v1.15ß:
  302.  
  303. Iwan Heskamp, Ron Burman, Jon Peterson, Max Headroom (? not sure if this is real name),
  304. and Javier De Las Rivas Fdez.  There was one other , but all I have is "Software Solutions"
  305. for a name and that he is in the Bahamas.  Thanks to you all.
  306.  
  307. Also, thanks to Carsten Sorensen for pointing out the bug fixed in v1.18.
  308.